home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util1 / 4dos402p.zip / UPDAT402.DOC < prev    next >
Text File  |  1993-03-30  |  21KB  |  523 lines
  1.  
  2.                                   JP Software
  3.  
  4.                            4DOS Update Documentation
  5.  
  6.                         Version 4.02 -- March 30, 1993
  7.  
  8.    Copyright 1988 - 1993, JP Software Inc., All Rights Reserved.  Published
  9.    by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174 USA, (617)
  10.    646-3975.
  11.  
  12.  
  13.    This file provides a list of changes in 4DOS version 4.02.  If you are
  14.    new to 4DOS with version 4.02, you can skip this file and begin with the
  15.    printed 4DOS Reference Manual, or with the ASCII manual in the file
  16.    4DOS.DOC.
  17.  
  18.    This file is intended for 4DOS 4.01 users upgrading to 4DOS 4.02.  If
  19.    you have an earlier version of 4DOS (3.x or 4.0) please review
  20.    UPDAT401.DOC for changes made through version 4.01 before reading this
  21.    file.
  22.  
  23.    Some of the descriptions below may be more detailed than you need; if
  24.    you aren't using the feature described, feel free to skip through to the
  25.    next item!
  26.  
  27.    There are feature changes in 4DOS 4.02 which may apply to you if:
  28.  
  29.       - you are using MS-DOS version 6.0
  30.       - you are using OS/2 version 2.1
  31.       - you want to be able to display times in "AM/PM" format
  32.       - you want to be able to display bright background colors
  33.  
  34.    If you're in one of these groups, check through this file for changes
  35.    which may affect you.  Otherwise, you can probably replace 4DOS 4.01
  36.    with 4.02 without noticing any change at all, and review the lists below
  37.    only if you have a question.
  38.  
  39.    The changes referred to above are marked with a "**" in the lists below. 
  40.    All items without a "**" are more technical or less important; you can
  41.    skip them unless you are trying to solve a particular problem, or are
  42.    looking for specific changes which may affect you.
  43.  
  44.    This file is formatted at 58 lines per page, and contains form feeds and
  45.    page footers.  It can be viewed with a file viewer such as the 4DOS LIST
  46.    command, or printed on most PC printers using the command:
  47.  
  48.             copy updat402.doc prn
  49.  
  50.    Printing it with a program that formats the pages is not likely to work
  51.    due to the formatting included in the file.
  52.  
  53.                                                                (3/93-4.02A)
  54.  
  55.  
  56.  
  57.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 1
  58.  
  59.  
  60.  
  61.                              4DOS 4.02 Change List
  62.  
  63.  
  64.    Startup and Initialization
  65.    --------------------------
  66.  
  67.       Three new startup switches are now supported in 4DOS:
  68.  
  69.    **    /P[:]filename sets the path and file name for the AUTOEXEC file in
  70.          the primary shell.  This is equivalent to using the //AutoExecPath
  71.          directive in 4DOS.INI.  It is included for compatibility with the
  72.          DOS_AUTOEXEC setting available under OS/2 2.1, and should not be
  73.          needed elsewhere.
  74.  
  75.          /D disables AUTOEXEC.  A /D overrides AutoExecPath and /A (see
  76.          above).  This switch is intended for internal use by MS-DOS 6.0
  77.          when you use the F8 key at boot time, and answer "No" to the "Run
  78.          AUTOEXEC" question.
  79.  
  80.          /K[:]command:  Run the specified command after 4DOS starts.  4DOS
  81.          4.01 supported this switch in OS/2 DOS sessions; it is now
  82.          available in a standard DOS boot as well.  For compatibility
  83.          reasons, in a primary shell under MS-DOS 6.0, /K will execute the
  84.          command INSTEAD of AUTOEXEC.BAT.  However in other environments
  85.          (DOS 5.0, OS/2 DOS sessions, etc.), /K will execute the command IN
  86.          ADDITION to AUTOEXEC.
  87.  
  88.  
  89.       The 4DOS manual has never stated any required order for items on the
  90.       startup command line.  In order for command line switches to properly
  91.       override items in the INI file, and in order for 4DOS to find the INI
  92.       file, you should use the following order in the command tail:
  93.  
  94.             - any "d:\path" for COMSPEC directory
  95.             - any explicit INI file name (@ininame)
  96.             - the /A, /E, /F, and /P switches, if used, in any order
  97.             - the /C or /K switch, if used
  98.             - any explicit startup command
  99.  
  100.       (For more information on startup options, see your 4DOS manual.)
  101.  
  102.  
  103.       There are two new directives in 4DOS.INI:
  104.  
  105.    **    AmPm = Yes | NO | Auto:  Yes tells 4DOS to display times in
  106.          12-hour format with a trailing "a" for AM or "p" for PM.  The
  107.          default of No formats times in military (24-hour) format.  Auto
  108.          formats the time according to the country code set for your
  109.          system.  The time format selected by AmPm applies to DIR and
  110.          SELECT displays, LOG files, the output of TIMER, and the DATE and
  111.  
  112.  
  113.  
  114.  
  115.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 2
  116.  
  117.  
  118.          TIME commands.  It does not affect %_TIME, %@MAKETIME, or PROMPT
  119.          $t and $T.
  120.  
  121.    **    BrightBG = Yes | No.  Yes switches the video board to display
  122.          bright background colors (rather than blinking foreground colors)
  123.          within 4DOS (what happens within other programs is up to them). 
  124.          No switches to blinking foreground mode and disables bright
  125.          backgrounds.  The default if BrightBG is not used is to leave the
  126.          video board in its current state and not adjust the mode at all. 
  127.          For further details before using BrightBG see the section on
  128.          "Color Changes" below.
  129.  
  130.  
  131.       The AutoExecPath directive in 4DOS.INI can now specify a path, or a
  132.       path and file name.  Previously this directive could only include a
  133.       path; the file name was always AUTOEXEC.BAT.  Now, if a file name is
  134.       included that file will be run instead of AUTOEXEC.BAT.  If only a
  135.       path is included, 4DOS will run AUTOEXEC.BAT from the specified
  136.       directory.  For example:
  137.  
  138.          AutoExecPath=C:\MYDIR
  139.             Runs the file C:\MYDIR\AUTOEXEC.BAT when the system boots.
  140.  
  141.          AutoExecPath=C:\MYDIR\MYSTART.BAT
  142.             Runs the specified file when the system boots.
  143.  
  144.       This change allows you to put multiple startup files for different
  145.       boot options or different OS/2 2.x DOS sessions into the same
  146.       directory, and pick the file to be run by changing the AutoExecPath
  147.       directive.
  148.  
  149.  
  150.    ** The default setting for the FullINT2E directive in 4DOS.INI is now
  151.       Yes.  This increases 4DOS's default memory usage by about 100 bytes,
  152.       but ensures compatibility with applications that use interrupt 2E. 
  153.       Only a few applications use interupt 2E to execute commands.  If you
  154.       don't run any such applications, you can save the space taken by
  155.       interrupt 2E support by including a FullINT2E=No directive in
  156.       4DOS.INI.
  157.  
  158.  
  159.    ** 4DOS fully supports the MS-DOS 6.0 multiple configuration facility
  160.       which allows menus in CONFIG.SYS.  This includes support for SET
  161.       statements in CONFIG.SYS, and for the CONFIG variable generated when
  162.       CONFIG.SYS menus are used.  Environment variables created from
  163.       CONFIG.SYS will be available within AUTOEXEC and 4START when the
  164.       primary 4DOS shell begins execution.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 3
  174.  
  175.  
  176.    ** Color Changes
  177.    ----------------
  178.  
  179.       There are two general changes to color specifications in 4DOS 4.02.
  180.  
  181.       First, the DRAWBOX, DRAWHLINE, DRAWVLINE, SCRPUT, and VSCRPUT
  182.       commands no longer accept border colors.  Border colors did not
  183.       always work as expected in these commands, and were never part of the
  184.       documented syntax.  To specify border colors you must use CLS or
  185.       COLOR, or the StdColors directive in 4DOS.INI followed by a CLS.
  186.  
  187.       Second, bright background colors can now be specified in color
  188.       settings on EGA and VGA systems.  The remainder of this section
  189.       describes the use of bright background colors.
  190.  
  191.       Bright background colors work only on EGA and VGA displays, and
  192.       should not be used on other systems.  They are an alternative to
  193.       blinking text, and you must choose one or the other:  if you enable
  194.       bright backgrounds, displayed text will not blink, and vice versa.
  195.  
  196.       To use bright background colors, enable them with the BrightBG
  197.       directive in 4DOS.INI (see Startup and Initialization changes above
  198.       for details).
  199.  
  200.       The syntax of color specifications has been changed to support bright
  201.       backgrounds.  The full syntax is now:
  202.  
  203.             [BRIght] [BLInk] fg on [BRIght] bg
  204.  
  205.       This change applies to all commands which accept color
  206.       specifications, and to all color directives in 4DOS.INI.
  207.  
  208.       Technical Notes:
  209.  
  210.          Bright background and blinking foreground colors use the same bit
  211.          in the video board's registers.  Therefore, you must have the
  212.          BrightBG setting and your color specifications properly
  213.          synchronized to get the desired result.  With BrightBG = No,
  214.          either "blink" or "bright [bg]" in the color specification will
  215.          result in blinking text.  With BrightBG = Yes, either
  216.          specification will result in a bright background.
  217.  
  218.          For example, these two color specifications will always produce
  219.          the same result on the screen:
  220.  
  221.                color blink white on blue
  222.                color white on bright blue
  223.  
  224.          If BrightBG = No, the above statements will both result in the
  225.          same blinking white text on a blue background.  If BrightBG = Yes,
  226.          they will both result in the same white text on a bright blue
  227.          background.
  228.  
  229.  
  230.  
  231.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 4
  232.  
  233.  
  234.          Setting BrightBG may not be compatible with all video boards, but
  235.          should work with standard EGA- and VGA-compatible systems.  If
  236.          BrightBG is set to Yes or No the video board bright background /
  237.          blinking foreground state is set each time 4DOS displays the
  238.          prompt.  If BrightBG is not used the video board state is not
  239.          adjusted at all.  If you experience screen "flashes" at each
  240.          prompt when BrightBG is used, then your video board probably is
  241.          not compatible with the approach used by 4DOS's bright background
  242.          support.  In this case, leave the BrightBG statement out of
  243.          4DOS.INI altogether to eliminate the "flashes".  This problem
  244.          should be very rare and is not likely to occur on standard EGA and
  245.          VGA systems.
  246.  
  247.  
  248.    Command Changes
  249.    ---------------
  250.  
  251.    ** DIR:  The following switch changes were made, for compatibility with
  252.       MS-DOS 6.0's DBLSPACE disk compression facility:
  253.  
  254.          /C:   The old /C (upper case display) switch has been changed to
  255.                /E.
  256.  
  257.          /C:   Display per-file and total compression ratios on drives
  258.                compressed with MS-DOS 6.0's DBLSPACE disk compression
  259.                utility.  The compression ratio is displayed instead of the
  260.                file description.  The ratio is left blank for directories
  261.                and files with length 0, and for files on non-DBLSPACE
  262.                drives.  /C only works in single-column mode, and is ignored
  263.                if /2, /4, or /W is used.
  264.  
  265.                The numerator for the displayed compression ratio is the
  266.                amount of space which would be allocated to the file on the
  267.                DBLSPACE drive if it were not compressed, using the DBLSPACE
  268.                drive's cluster size (normally 8K bytes).  The denominator
  269.                is the space actually allocated for the compressed file.
  270.  
  271.          /CH:  Display compression ratios like /C, but base the calculation
  272.                on the host drive's cluster size.  This gives a more
  273.                accurate picture of the space saved through compression than
  274.                is given by /C.
  275.  
  276.                PLEASE NOTE:  /CH will occasionally display compression
  277.                ratios slightly less than 1.0 to 1.0.  This reflects files
  278.                which have actually expanded when stored on the DBLSPACE
  279.                drive.  COMMAND.COM may display these ratios as 1.0 to 1.0,
  280.                even if the true ratio is slightly less.  4DOS always
  281.                displays the true ratio.
  282.  
  283.          /O:c  Sort by DBLSPACE compression ratio (the least compressed
  284.                file in the list sorts first; the most compressed file sorts
  285.                last).  The sort can be reversed with /O:-c.  For single-
  286.  
  287.  
  288.  
  289.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 5
  290.  
  291.  
  292.                column directory displays, /O:c implies /C -- in other
  293.                words, compression ratios will be displayed as well as used
  294.                for the sort order.  For wider displays (/2, /4, etc.) the
  295.                ratios will be used to determine the order, but will not be
  296.                displayed.  If /O:c is used /O:i (sort by description) will
  297.                be ignored.  If /CH is used with /O:C the sort will be by
  298.                compression ratios base don the host drive cluster size.
  299.  
  300.  
  301.    ** LH / LOADHIGH:  Now support loading memory-resident programs into
  302.       specific regions in upper memory.  These new features are designed
  303.       for compatibility with MS-DOS 6.0's COMMAND.COM, but will also work
  304.       with MS-DOS 5.0 and in OS/2 2.0 VDMs.
  305.  
  306.       The full syntax for LH is now:
  307.  
  308.             LH [/L:r1,n1;r2,n2;... /S] [d:][path]filename
  309.  
  310.       To use the new upper memory region switches you must meet ALL of the
  311.       following requirements:
  312.  
  313.          - You must be running MS-DOS / PC-DOS 5.0 or above, or a DOS
  314.          session under OS/2 2.0 or above.
  315.  
  316.          - You must have one of the following memory management packages
  317.          running:  EMM386 and HIMEM.SYS from MS-DOS / PC-DOS 5.0 or above;
  318.          386MAX from Qualitas; QEMM from Quarterdeck; or DOS session memory
  319.          management under OS/2 2.x, with UMB support enabled (typically via
  320.          the /UMB switch on the VXMS.SYS line in your OS/2 CONFIG.SYS
  321.          file).
  322.  
  323.          - You must have a DOS=HIGH,UMB or DOS=UMB statement in CONFIG.SYS;
  324.          or under OS/2 2.x, you must have the DOS_UMB setting for the
  325.          session set to "On".
  326.  
  327.       The new LH / LOADHIGH options are:
  328.  
  329.          /L:r1,n1;r2,n2;...:  Give the program access to upper memory
  330.          region r1 if that region has at least n1 bytes available, to
  331.          region r2 if it has at least n2 bytes available, and so on.  If /L
  332.          is not used, the program is given access to all upper memory
  333.          regions.
  334.  
  335.          Region numbers beyond those that exist on your system will be
  336.          ignored, with a warning.  The figures for space required in each
  337.          region (n1, n2, etc.) are rounded up to the nearest 16 bytes.  If
  338.          the free space in any region is less than the space required for
  339.          that region, then the region will be locked out and unavailable to
  340.          the program.  If the required space value is left out the program
  341.          is given access to the region regardless of the amount of free
  342.          space available.
  343.  
  344.  
  345.  
  346.  
  347.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 6
  348.  
  349.  
  350.          The program, its environment block, and any data allocated by the
  351.          program, will be loaded only into the region(s) allowed by the /L
  352.          switch; all other regions will be locked out and made unavailable
  353.          to the program.  If a program requests memory beyond that
  354.          available to it in upper memory, DOS will normally allocate low
  355.          memory (below 640K) to fulfill the request.
  356.  
  357.          Regions are numbered beginning with 1.  If you specify region 0
  358.          the program and its environment will be loaded into low memory,
  359.          and any other region(s) specified will be available for allocation
  360.          of program data.  Any minimum size for region 0 will be ignored.
  361.  
  362.          For example, for a simple load into region 2 only, regardless of
  363.          the space available in that region:
  364.  
  365.                LH /L:2 progname ...
  366.  
  367.          For access to region 2 if it has 10000 bytes free, and region 3 if
  368.          it has 15000 bytes free:
  369.  
  370.                LH /L:2,10000;3,15000 ...
  371.  
  372.  
  373.          /S:  Shrink each specified region to the minimum available size
  374.          before loading the program.  If /S is not used all space in the
  375.          specified region(s) is made available to the program.  You can use
  376.          /S to prevent a program from taking more than the minimum
  377.          specified space in a particular region (e.g. to limit memory used
  378.          by a cache that takes whatever memory it can get).
  379.  
  380.          For example, to load a cache program into low memory, give the
  381.          program access to region 2 for data as long as there is at least
  382.          16K free in region 2, and also limit the program to using no more
  383.          than that 16K:
  384.  
  385.                LH /L:0;2,16384 /S mycache ...
  386.  
  387.          The /S switch is intended for use by MS-DOS 6.0's MEMMAKER
  388.          utility.  It will not be especially useful for other purposes
  389.          unless you are involved in complex manual adjustments to upper
  390.          memory allocations, and have a thorough understanding of the
  391.          memory allocation strategies used by the programs involved.
  392.  
  393.  
  394.    ** MOVE:  MOVE now intercepts attempts to perform an infinitely
  395.       recursive MOVE /S, and displays an error message.
  396.  
  397.  
  398.    ** SELECT:  There are several switch changes to support MS-DOS 6.0's
  399.       DBLSPACE disk compression.  The upper case display switch has been
  400.       changed to /E, and there is new compression support provided by /C,
  401.       /CH, and /O:c.  See DIR above for details.
  402.  
  403.  
  404.  
  405.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 7
  406.  
  407.  
  408.  
  409.    Bugs Fixed
  410.    ----------
  411.  
  412.       A /E:nnnn setting on the startup command line was not overriding an
  413.       Environment= setting in the default 4DOS.INI file.
  414.  
  415.       A /F on the startup command line was not overriding a CritFail=No in
  416.       the default 4DOS.INI file.
  417.  
  418.       4DOS occasionally displayed an incorrect filename in error messages
  419.       related to 4DOS.INI.
  420.  
  421.       If there was no 4DOS.INI file in the directory with 4DOS.COM, 4DOS
  422.       was sometimes looking for it in the root directory of that drive,
  423.       rather than the documented location of the root directory of the boot
  424.       drive.
  425.  
  426.       The 4DOS PSP in upper memory was not chaining back to the low-memory
  427.       PSP when UMBLoad was used.  This fix should solve some very rare
  428.       problems with programs that trace down the PSP chain.
  429.       Redirection was not properly backing up over an end of file mark (^Z)
  430.       when appending to an existing file.
  431.  
  432.       Filename completion could not handle illegal DOS filenames like
  433.       OS/2's "EA DATA. SF" properly.  (You still can't USE these filenames
  434.       in commands, but they will no longer cause trouble with filename
  435.       completion when you go past them.)
  436.  
  437.       %_ALIAS and the MEMORY command did not agree as to the amount of free
  438.       alias space.
  439.  
  440.       When a prompt was displayed in a command with a /P switch (e.g. COPY
  441.       /P), pressing a non-printing key would display garbage characters.
  442.  
  443.       A bug in MS-DOS JOIN sometimes prevented 4DOS from correctly
  444.       identifying JOINed directories as directories.  We have worked around
  445.       this bug.
  446.  
  447.       COPY and MOVE:  Occasionally would not properly handle attempts to
  448.       copy OS/2 Extended Attributes to file systems that did not support
  449.       them.
  450.  
  451.       DEL /Q:  Conflicted with include lists so that only the first file on
  452.       the list was deleted.
  453.  
  454.       EXCEPT:  Using EXCEPT (*.) ... to prevent processing of files with no
  455.       extension could cause problems in EXCEPT's handling of the
  456.       directories "." and "..".
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 8
  464.  
  465.  
  466.       EXIT:  4EXIT would not always be run when EXITing from a batch file. 
  467.       Also an infinite loop would occur if an EXIT command was included in
  468.       4EXIT.
  469.  
  470.       LH / LOADHIGH:  Fixed a problem which could very rarely cause a crash
  471.       on return from a TSR loaded with LOADHIGH.
  472.  
  473.       MOVE:  Incorrect moves could occur when the source file was on a
  474.       Netware Lite drive.  These problems were due to network bugs, not
  475.       4DOS bugs; we have worked around the network problems.
  476.  
  477.       SELECT:  The displayed counter would overflow when tagging over 64MB
  478.       of files.
  479.  
  480.       Y:  had several minor problems when used at the console.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.    4DOS 4.02  [3-30-93]          UPDAT402.DOC                        page 9
  522.  
  523.